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Preface 



This manual describes the Symbolic Editor - a disk file 
editing utility which allows you to examine, analyze, 
and modify the contents of disk files. The Symbolic 
Editor (SED1T) works on random or contiguous files 
produced within Data General's Real-Time Disk 
Operating System (RDOS) or Diskette Operating 
System (DOS). 

SEDIT resembles the RDOS symbolic debuggers very 
closely (although it cannot set breakpoints or run a 
program). 

This manual is organized as follows: 

Chapter 1 introduces SEDIT, describes special 
characters, and explains SEDIT error 
responses. 

Chapter 2 tells you how to invoke SEDIT from the 
CLI; then it describes the commands 
which change output and enter data. 
Examples show you how to open, 
examine, and modify the contents of 
save, overlay, and text file locations. 

Chapter 3 begins by describing the special SEDIT 

registers; it then explains how you can use 
these registers to find and modify 
locations. 

Chapter 4 covers SEDIT symbol recognition: how to 
disable and enable global and local 
symbols. 

Chapter 5 summarizes the SEDIT commands 
alphabetically. We have printed this 
chapter on yellow stock for easy 
reference. 

Appendix A lists the SEDIT error messages and 
explains their causes. 



Reader, Please Note: 

We use these conventions for command formats in this 
manual: 

COMMAND required [optional] ... 

Where Means 

COMMAND You must enter the command (or 
its accepted abbreviation) as 
shown. 

required You must enter some argument 

(such as a filename). Sometimes, 
we use: 

^required 1 1 
j required 2 j 

which means you must enter oneof 
the arguments. Don't enter the 
braces; they only set off the choice. 

[optional] You have the option of entering 

this argument. Don't enter the 
brackets; they only set off what's 
optional. 

You may repeat the preceding 

entry or entries. The explanation 
will tell you exactly what you may 
repeat. 

Additionally, we use certain symbols in special ways: 
Symbol Means 



) 



□ 



Press the RETURN key on your 

terminal's keyboard. 

Be sure to put a space here. (We use 
this only when we must; normally, 

you can see where to put spaces.) 
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All numbers are octal unless we indicate otherwise; 
e.g., 35 !0 . 

Finally, we usually show all examples of entries and 
system responses in THfS TYPEFACE. But. where we 
must clearly differentiate your entries from system 
responses in a dialog, we will use 

THIS TYPEFACE TO SHOW YOUR ENTRY ) 
THIS TYPEFACE FOR THE SYSTEM RESPOSSE 
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For example: 

START/ 020440 ; EDA O.OVL Y 

Here, the person at the console typed START/ and 
SED1T returned 020440. Then the person ivped • and 
SED1T returned LDA .OVLY. 



End of Preface 



iv 
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Chapter 1 
Introduction 



Data General's Symbolic Editor (SEDIT) allows you to 
edit disk file locations symbolically in any random or 
contiguous file created on an RDOS or DOS system. 
SEDIT is compatible with the RDOS debuggers and 
shares many commands with them. (To emphasize this 
similarity, we use the terms "location" and "address" 
interchangably within this manual.) 

With SEDIT, you can display and modify locations in 
octal, or in instruction, system call, byte, or ASCII 
format. You can display whole blocks of words and use 
special registers (described in Chapter 3) to find and 
modify locations. SEDIT works best on programs 
which have been loaded with a program symbol table, 
and on text files. You can patch operating system files 
with SEDIT, in octal -- but you may find the ENPAT 
and PATCH utilities easier to use for this. 

SEDIT is unique among Data General disk editors in 
that it searches the disk file for symbolic values. For 
example, take the instruction JSR © 50 in a program. 
Using symbols, SEDIT might display this as 

JSR ® SAV 

which tells you about the symbolic address for the JSR. 
SEDIT can also access a program's overlay file from its 
save file. 



registers, and enable or disable symbol recognition. 
Local commands open and close locations and display 
data words in different formats. 



Note on Consoles 

The following guidelines apply not only to SEDIT, but 
to all other RDOS disk editors and symbolic debuggers. 

If you have an upper/lower case console, set it on 
ALPHA LOCK before trying to use these utilities, 
because they don't recognize lower-case letters. 

One command common to all utilities has been called 
LINE FEED (1) in our manuals. ANSI-standard 
terminals, like Data General's DASHER printer or 
display Model 6053, do not have a LINE FEED key; 
instead, they have a NEW LINE key, and you can press 
NEW LINE to enter this command. On a non-ANSI 
standard console, press the LINE FEED key. In this 
manual, we call this command NL/LF, and show it as 
(I). 

Another common command has been called SHIFT-N 
(f). On a DG upper/lower case console, press SHIFT-6 
instead of SHIFT-N to enter this command. In this 
manual, we call this command uparrow and show it as 

(f). 



Commands 

Each SEDIT command is a single character, which you 
sometimes precede with ESC (echoed as S), an 
address, or a symbol, SEDIT has both global 
commands and local commands. Global commands 
direct searches, display ranges of locations, set 
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Special Characters 

As mentioned in the Preface, we use italic type in 
examples to indicate SEDIT output, and boldface type 
to signify your input. All numbers are octal, unless 
shown otherwise. Other special keyboard characters 
and their meanings are: 

Character Meaning 



CTRL-A 

(Press CTRL 
and A keys) 

CTRL-Q 
CTRL-S 



Interrupt the current SEDIT command 
and return the SEDIT prompt. 

Resume console display from the point 
at which CTRL-S suspended it. 

Pause while displaying output on the 
console. CTRL-S/CTRL-Q are useful 
for long displays on CRTs. They work 
on all DG consoles. 

Carriage RETURN. 

NEW LINE or LINE FEED (NL/LF). 

Uparrow. Press SHIFT and 6 or SHIFT 

and N keys. 

ESC. Press ESC key. 
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Typing Errors 

If you make a mistake while typing input to SEDIT 
before you press ), press the RUBOUT key. SEDIT will 
respond with U , close the current location, and display 
its prompt on a new line. You can then type another 
command. 



Actually, you can use any undefined character to do 
what RUBOUT does, but RUBOUT 

convenient. 



is most 



SEDIT Error Responses 

SEDIT has two common error responses: U and ?. 
(Other SEDIT error messages are explained in 
Appendix A.) 

U means that the characters you've typed are 
undefined. This can result from a simple mistake, 
or it may mean that your program doesn't include a 
symbol table, or that you have not enabled this 
symbol. 

? means that your command syntax was wrong. 
Global commands must start on a new line, 
immediately after the prompt. This can also occur if 
you type more than six octal numbers, or any value 
which exceeds 2 16 -1 (e.g., 277777 or 88000.), or 
numbers, or if you use a space in an expression 
(e.g., START o +10). 

After it detects an error, SEDIT closes the current 
location (if open), and outputs a carriage return and its 
prompt. These errors do no harm. 



End of Chapter 
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Chapter 2 
Operating SEDIT 



This chapter tells you how to execute the SEDIT 
program from the CLI. It also shows you how to 
include a symbol table (which you need to edit a save 
file symbolically), and describes the commands to 
change SEDIT output format and input new- 
information. Then it explains editing an overlay file, 
and ends by showing you how to edit a text file. 

Invoking SEDIT 

You invoke the SEDIT utility with the command: 

SEDIT filename } 

where the filename is the name of any RDOS or DOS 
random or contiguous file. 

SEDIT searches for the filename specified; if it can't 
find the filename and you omitted an extension (e.g., 
.SV), SEDIT searches for the filename with the .SV 
extension. Because SEDIT allows you to edit any 
overlay for any node from the save file, it is generally 
easier to edit an overlay file while editing the save file 
than to edit the overlay file directly. 

When SEDIT finds the file, it opens it, then displays a 
revision number and a period prompt (.). You can then 
enter SEDIT commands. If the file is read- or 
write-protected, SEDIT displays a PROBLEM 
READING FILE error message and returns to the CLI 
when you try to read or modify the fife. 



When you have finished editing, type ESC Z (echoed 
as SZ) to terminate SEDIT and return to the CLI. For 

example: 



SEDIT MYPROG ) 
SEDIT REV x.xx 



.START/ 020451 



SZ 

DONE. 

R 



Invoke SEDIT. 

The period is SEDIT's prompt. 
Enter SEDIT commands. 
Return to the CLI. 



Global Switches: 

/N Do not search for a symbol table. Use this switch 
along with global /Z to edit a text file, or if the 
program lacks a symbol table. SEDIT mav displav a 
NOT ENOUGH MEMORY FOR SYMBOL 
TABLE error message if the program lacks a 
symbol table and you use /Z without /N. 

/Z This file starts at location zero. You must use this 
switch to edit a text file or stand-alone program 
file; do not use it for a conventional save file. 
Programs you can execute under RDOS begin at 
location 16; SEDIT assumes this if you omit IT. 
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Including Symbols in Save and 
Overlay Files 

If you want to edit a save file symbolically (instead of 
exclusively with octal locations), you must include user 
symbols. SEDIT will not recognize any symbols at all 
unless the program includes a program symbol table. 
You can instruct RLDR to include both a symbol table 
and debugger with the RLDR/D switch; or you can 
have it include a symbol table alone by writing a .EXTN 
.SYM, statement into one of the program modules. 

if the program includes a symbol table, SEDIT 
automatically recognizes global symbols (those 
specified in a .ENT psuedo-op in the program). To use 
local symbols (those not identified by .ENT), you must 
insert the global /U switch in the assembler command 
line, and the local /U switch in the RLDR command 
line. Having included local symbols, you then tell 
SEDIT to seeihcm with the SEDIT command name%. 

For example, assume that you want to include ail 
symbols from two source files (named MYPROG and 
MYPROG I) in save file MYPROG. You'd follow these 

steps: 



MAC/U MYPROG; MAC/U MYPRCG1 
ASM/U MYPROG; ASM/U MYPROG1 



RLDR/D MYPROG/U MYPROGt/U SLPT/L) 



This produces save file MYPROG.SV, and sends the 
load map to the line printer. (It's very helpful to have a 
copy of the map.) If either MYPROG or MYPROG I 
included a .EXTN .SYM., you could omit the RLDR 
global /D switch. 

To enable local symbols in overlays, you'd append 
global /U to each overlay name; e.g RLDR/D 
MYPROG/U MYPROG1/U [OVLYO/U, OVLY1/UJ. 

SEDIT MYPROG } 
SEDIT REVx.xx 

.MYPROG% 
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SEDIT Command Format 

All SEDIT commands have the format: 

[address! command [reply] [new-contents] [) ] 

The address can be a number, symbol or period. Each 
SEDIT command is a single character. Commands 
which display an address are entered alone; these are 
called local commands. You enter other commands by 
pressing the ESC key, then the command letter; these 
are global commands. You can enter multiple local 
commands on one line, but you must start each global 
command on a new line. The reply is SEDITs response 
-- often the contents of address. You enter the 
new-contents (in any format described below) only if 
you want to modify the current contents. A carriage 
return tells SEDIT to accept the new-contents (if any) 
preceding; it also closes the current address and 
displays a new prompt. SEDIT will output a carriage 
return if you make a syntactical mistake or enter an 
undefined symbol. Here are three local commands in 
one line: 

.START/ 020440; IDA OER + 10 LDA 0, ER + 7) 

START is an address, "/*' is a local command which 
opens and displays the address symbolized by START 
and 020440 is SEDFTs response, which indicates the 
contents of the address. The semicolon (;) is another 
command, which tells SEDIT to display the contents in 
instruction format (instead of octal); LDA £7? 4-/0 is 
SEDIT's translation of 020440 into instruction format. 
The last entry made by the user, specifies the new 
contents for address START; the } installs the new 
contents and closes the address. 

An example of a global command is: 

.SH 000000 1 } 

This opens the output register (described in Chapter 
3), and stores 1 in it; this sends all output of search 
commands to the line printer. Global commands 

remain in effect until you change them. 



Chapter 4 describes enabling and disabling user 
symbols. 
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Location and Display Commands: 

Location commands open and close locations; display 
commands show the contents of these locations in 
different formats. When you open a location, it 
becomes the current location: this does not change until 
you access another location. 

Location Commands 
Command Effect 



addr/ 



addr! 



Open address addr and display 
contents. 

Open address addr and display 
nothing. 



1 (NEW LINE Close current address (if open), open 

or and display next address. (Use NEW 

LINE FEED) LINE if your terminal lacks a LINE 

(NL/LF) FEED key.) 



I (SHIFT-N 

or 

SHIFT-6) 

) (RETURN) 



/ (slash) 



Close current address (if open), open 
and display preceding address. 



Close current location (if any); return 
prompt. The closed location remains 
the current location. 

Close current location (if open) and 
open location specified by contents of 
current location. This is useful for 
pointers (e.g., .LOAD/ LOAD 1 LDA 
TEMP). 

Display current location in current 
radix (e.g., 5005). 

Display current location symbolically 
(e.g., LOQP + 6). 



When a location is open, SEDIT will generally try to 
insert whatever you type as the new contents for that 
location. If you don't want to modify the contents of an 
open location, be sure to close it with one of the 
commands above before typing new data. If you do 
type characters which you don't want SEDIT to try and 
insert in this location, press RUBOUT; this closes the 
current location without changing anything. 
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Display Commands 

The display commands act on the last entry which 
appears on the console. This can be an entry which you 
have typed in, or which SEDIT has displayed; or it can 
be an address or the contents of an address. 

Command Effect 

- Display last entry in current radix (the 
default is octal). A .= command 
displays the current numeric location. 

Display last entry in machine 
instruction format (e.g., MOVS 0). 

' (apostrophe) Display last entry in ASCII format (e.g., 
HI or <n><n> if nonprinting 
characters). 

\ (backslash) Display last entry in .SYSTM command 
format (e.g., .RDLO). 

— (backarrow Display last entry in half-word format 
orSHIFT-O) (e.g., 14 17). 



& 



Display last entry in byte-pointer format 
(e.g., 3007 1). 

Display last entry in symbolic format 
(e.g., LOOP+20). 

Display last entry in symbolic format 
with bit zeroed. 

Display current numeric location (e.g., 
005005). (As with other utilities, you 
can enter a period (.) to indicate the 
current location.) 

Display current symbolic location (e.g., 
START). If no symbol is defined within 
2000 locations, : displays location 
numerically. 

Display decimal number n in current 

radix (default is octal). See Chapter 3, 
Number Register, for other 
conversions. 

Display hexadecimal number nx in 
current radix, n must be a digit from 
0-9; x can be any hex number(s) or hex 
letter(s). 



Figure 2-1 shows examples of the local commands 

shown above. 



n.= 



nxH = 



093-000160-00 



2-3 



Location and Display Commands 



DataGeneral 

SOFTWARE DOCUMENTATION 



Licensed Material - Property of Data General Corporation 



SEDITMYPROG ) 
SED/TREVx.xx 
.START/ 020440 ) 

. > 000452 ) 
. ..START) 
.START! ) 

■1 

START + 1 I26400{ 

START+2 006017] 

ST ART +1 126400) 
. .: START+I I 

START +2 0060 17 
J 146032) 

ST ART + 2/ 006017 
;JSR & OVLY1 + /6 
' < 14> < 17 > 
\.WRB 17 
-14 17 
& 30071 
:6017 
* 6017 

.'.START+2 
.9999.= 023417 
OFH= 000017 
2FFAH= 027772 



Invoke SEDIT. 



Open address START and display its contents (octal by default); close location with ). 

Current address remains 452, 
which is START symbolically. 

Open address START without displaying contents; close location. Address remains 
START. 

NL/LF closes current location (if open); then opens and displays next location 

Close START+ 1; open START + 2. 

Uparrow closes current location (if open); then opens and displays previous location. 

) closes. 

Current address remains START+l.NL/LF opens next: START + 2 contains 6017. 

Use contents of START + 2 (6017) as address; open and display address 6017. 

Open and display START+2 in octal, 

display in machine instruction format 

then in ASCII format (nonprinting values), 

then in .SYSTEM command format, 

then in half-word format. 

then in byte-pointer format, 

then in symbolic format (not a symbol), 

then in symbolic format, OBO (here there is no difference between : and *), 

then, display current location symbolically. 

Convert decimal 9999 (period indicates decimal) to octal. 

Convert hex numbers F and 

2FFA to octal. 



- Figure 2- 1. Local Commands Example 



You can convert most display commands into global 
commands by typing ESC, then the command. SEDIT 
then displays contents of addresses in the new format 
until you change it again. You can continue to use other 
display commands as usual. For example: 



.START/ 020440 ) 
■ S; 

.START/ LDA0ER + 101 
START+1SUB 1 1 1 
STA R T+ 2 JSR®OVl + 16\ 
START+ 3 ISZ 0\ .OVOP } 



.START + 3/ 012000 



Octal mode. 
Change display mode. 

New mode 
continues.... 



Display 
format. 



in 



other 



Change mode. 

New mode continues. 



You can enter new contents for an address in any 
mode, including the special data entry modes described 
next. For example: 

.START + 35/ 125120;MOVZL 1 1 M0V2R 1 1 

.START + 35/ 125220 :MOVZR J \ 

Change c.;^*e^; s of START- 1 - 35 fr-.-r- VOV'ZL 1 I to 

MOVZR 1 1, then verify the change. 1 he display mode 
remains octal throughout. 



SEDIT also allows you to examine radix 50 symbols. 
Ail user symbols are stored in radix 50 in the program 
symbol table; this allows any symbol to fit in two 16-bit 
words. You can use the left brackets to displav the 
symbol name. The format is: 

firstwordlsecondwordl 

For example, assume that you are stepping backward 
through a symbol table: 

TO VL+ 271 000000 \ 
TOVL+270 131401] 
T.OVL+267 113014131401 [113024[ ROOT 

(This works because RLDR builds the symbol table 
downward- not upward as it does the rest of the save 
file.) You need not actually type the numbers before 
the brackets -- simply type the bracket after the 
appropriate number appears: 

TO VL+ 27 1 000000] 
T.OVL+270 131401 [\ 
T.OVL+267 1130141 ROOT 

To do this, remember f stay in synch - every second 
bracket must follow the first word of the 'symbol. 
Symbol entries in the tabic are three words long. ' 



2-4 
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SEDIT also offers two special data entry formats, which 
allow you to translate ASCII characters, or bytes into 
any format, or enter characters or bytes in the current 
open location. To enter ASCII characters, precede 
them with a quotation mark ("}. You can (but need 
not) enter a closing quote. For example: 

."AB = 040502 ; STA ER + 52 'AB) 
.START/ 0220440 "AB ) 
.START/ 040502 'AB 

The first line displays an ASCII AB in different 
formats; the second line inserts AB in location START. 
You can use any two ASCII characters after the quote; 
e.g., "A = 040440. To enter a quote, you must type two 
sets of quotation marks. For example, to enter "A, 
you'd type " " "A" or '* " "A. 

To enter data in bytes, use the format nln, where n is a 
byte of information. For example: 

.1011= 004001 ■ <10><1>) 
.START/ 020440 377)0 } 

The first line displays the word containing 10 in its left 
byte and 1 in its right byte. The second line inserts a 
word containing bytes 377 and in location START. 

If n is too large, SEDIT includes only the digit (s) which 
fit into eight bits. 

Calculations 

SEDIT has two arithmetic operators, plus ( + ) and 
minus (-). You can use these operators for calculations, 
or to access locations. For example: 



.4567 + 123= 004712 
.999. + 5678.= 015025 

.START/ 020440 

.START = 000452 

. .+ 12= 000464/126400 



.ER- 00502 



.-10= 000454/006017 



Add octal numbers. 

Add decimal numbers, 

result in octal. 

START contains 020440. 

START is location 452. 

Add 12 to current 

location, result is 464, 

open location 464. 

ER is location 502; 

current location remains 

464. 

Subtract 10, result is 454, 

open location 454. 



Examples 

Assume that you have determined with a debugger that 
you want to change an instruction in a program — well 
call it WRITE.SV. You can't or don't want to change 
the source program and reassemble and reload this 
program; you simply want to run it. 



SEDIT WRITE ) 
SEDIT REV x.xx 
.WRITER 

Get into SEDIT and enable local symbols. 

.START + 1 0/ 020445 ; IDA STA R T+ 35 \ . CCON 45 

Display the contents of START+10 in octal, 
instruction, and system call format (the latter is 
meaningless). 

START+ 11 0006017 ;JSR @ 17 \ 
START+ 12 021027; IDA 27 2 

After examining succeeding locations, you decide to 
change the display mode to instruction format because 
you're looking for a machine instruction. 

) 
• S; 

.START + 32/ JXiP START + 45 \ 
START + 33 LDA 2START+ 71 { 
ST ART +34 LDA 1 START+ 74 \ 
START+ 35 AND 1 2 ANDS 1 2 ) 

Find the faulty instruction and change it to ANDS 1 2. 
Verify the change: 

START + 35/ ANDS 1 2) 

And leave SEDIT: 

.SZ 

DONE 

R 

You can now run the program. 

Editing Overlays(SO) 

Using SEDIT, you can edit any overlay as if it were part 
of the save file. SEDIT opens the overlay file and reads 
the overlay you specify into its node; after editing, it 
writes any changes you make back to the overlay file. 
You can read any overlay into its node at any time. 

If you have identified an overlay with the .ENTO 
pseudo-op, you can read the overlay into its node by 

typing: 

overlaynameSO 

If .ENTO was omitted from the overlay, you must 
specify the node number and overlay number: 

nodeloverfaySO 

where node is the node number (0 for the node defined 
by the first pair of brackets in the RLDR command 

line, 1 for the node defined by the second pair of 

brackets, and so on), and overlay is the overlay number 
(0 for the first binary within the square brackets, 1 for 
the second binary within the square brackets, and so 
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on). We used byte entry to enter the node and overlay 
numbers; you can use a word with the node number in 
the left byte and overlay number in the right byte (e.g., 
for node zero, overlay zero, I for node zero, overlay 
1, and so on). 

For the rest of this section, we'll be using a save and 
overlay file created by the command line: 

RLDR/DROOT/U [OVLYO/U, OVLY1/U] ) 

This creates save file ROOT.SV, with one node, and 
overlay file ROOT.OL, which holds overlavs OVLYO 
and OVLY1. OVLYO and OVLY1 contain a .ENTO 
OVLYO and an .ENTO OVLY1 statement, 
respectively. RLDR's load map shows that the overlay 
node begins at location 5 1 7 and ends at 1 1 1 7. 

You can enable or disable symbols at any time, as 
described further in Chapter 4. When you enable 
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symbols in one module, you disable symbols in the 
current module. 

When you load another overlay after you have enabled 
symbols in an overlay, SEDIT displays symbols exactly 
as they were in the original overlay. For example, in the 
second overlay below, PRNTB might have really 
contained the instruction LDA 0, FILEA instead o'f 
LDA B. This can be very confusing, so you can clarify 
overlay symbols by following this sequence when you 
want to edit successive overlays in the same node: 

1. Enable local symbols if you need them for next 
step. 

2. Get to node start and enable symbols in the desired 
overlay (ovlyname%). 

3. Read in the desired overlay (oviynameSO or 
nodelovlySO). 

4. Edit the overlay. 

5. Re-enable symbols in the root program (e.g., 
ROOT%);gotostep2. 



SEDIT ROOT} 

SEDIT REV x.xx 

.ROOT% 

.515/ 027117 '.0\ 

OFILE+4 046000 ' L <Q> \ 

PRNTB 000000 . - 00051 7 \ 

PR STB +1 000000 | 

PRNTB + 2 000000[ 

PR NTS + 3 000000) 

.OVLYOSO 

.515/ 027 1 17'. 0\ 

OFILE + 4 046000' L <0> \ 

PRNTB 020407 

;LDA0PRNTB+7{ 

PRNTB + 1006017 

;JSR @ NSW+161 

PRNTB + 2 OIOOOOX.PCHA [ 

PR NTS + 3 002430 

;JMP @ PRNTB + 6) 

.OVLYO% 

.PRNTB/ 020407; LDA 0B{ 

PRNTB + 1006017 

;JSR @ NSW+161 

PRNTB + 2 01 000 \ .PC HA } 

.OVLY1SO 

.ROOT% 

.51 5/ 020407 '.O I 
OFILE+4 046000 ' L <Q> \ 
PRNTB 020407 
;LDA0PRNTB+7\ 
PRNTB + 100601 7 
;JSR @ NSW + 161 
PRNTB + 2 015401 \ . RDL 1 



Enable local symbols. 

Approach the node start (this is the end of the overlav file text strine 

ROOT.OL.) " B ' 

Symbol OFILE points to the overlay file name. 

PRNTB is vacant, as is the rest of the node. There's a value for it in the first 

overlay. 



Load OVLYO into its node (without .ENTO, you'd use 0J0SO). 

Approach node as before... 

Same value at 516. 

A value for PRNTB! It is an instruction. The overlay is in the node. 

PRNTB + 1 holds an instruction, and PRNTB + 2 holds a system call. 



And PRNTB + 3 hoids another instruction. 

Enable symbols in first overlay. SEDIT displays LDA B instead of LDA 

PRNTB + 7. 

Enabling overlay symbols doesn't affect display of PRNTB + 1 or PRNTB + 2. 



Load OVLY1 into node - it replaces overlay 0. 

Enable ROOT's symbols; we won't enable symbols in this overlay for reasons 

explained above. 

Approach node again... 

Same value at 516. 

Same value -- (instruction) in PRNTB. 

Same value in PRNTB+ I - (instruction). Is this the same old overlay? 

No. This used to be 010000, .PCHA 0. The second overlay is in the node. 
— Figure 2-2. Loading and Exammtng Overlays ■ — - 
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Text Files 

When you invoke SEDIT to edit a text file, use the 
global /Z and /N switches. Generally, you'll be 
displaying locations in ASCII mode ($'), and using the 
ASCII entry operator (**xx) and byte entry operators 
(n]n). 

To help illustrate, assume that you have created a text 
file via the CLI by typing: 

XFER/A STTI F1LEA/R } 
MESSAGE HELLOiDtSK ) 
CTRL-Z 

You need the /R switch in RDOS to organize the file 
randomly. (The text editors automatically create 
random files.) 

Now you invoke SEDIT by typing: 

SEDIT/Z/N FILEA } 
SEDIT REV x.xx 



The /Z switch tells SEDIT that the file begins at 
location zero; if you forgot it, SEDIT would display the 
first 15 (octal) location contents as 0, and you could not 
edit the file accurately. The /N switch instructs SEDIT 
not to look for a svmbol table: if vou forgot it, SEDIT 
might display a NOT ENOUGH MEMORY FOR 
SYMBOL TABLE error message and return to the 
CLI. 
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Now, check the locations and add a CLI command: 



.0/ 046505 'ME) 


The first two locations 




contain "ME". 


.$' 


Change to ASCII Display. 


4 


Display next location: 


+ ISSI 


And next; 


+ 2 AG I 


And next; 


+ JEI 


And so on; 


+ 4HE\ 




+ 5LL\ 




+ 6 0:1 




+ 7D1\ 




+ I0SK[ 


Here, the text message 



+ // <15><0> I 
+ /2<0><0> ) 
.1 1/<15> <0> ";L) 

+ 12 <0><0> "!S1 

+ 13 <0><0> "T/» 

+ 14 <0> <0> "N<1 ? 

.14/<0> <0> 116)15) 

.14/N<15> t 
+ 15 <0><0> ) 

.sz 

DONE. 
R 



ends. 

CR and null are the last 

nonzero words. 

Now, to add a list 

command: 

Use " to insert ;L in 

location 1 1. 

Check 1 1 and open next 

location. 

Place IS in 12; open next 

location. 

Place T/ in 13, open next 

location. 

You can't use " to enter 

more than two characters. 

Try byte entrv operator 

(n]n). 116 = ASCII N. 

Byte entry operator works! 

Location 15 is unchanged. 

Leave SEDIT. 



Now, we've added the CLI command LIST/N to the 
file. Verify it: 

TYPE FILEA) 

MESS A GE HELL0;D1SK;L1ST/N 

R 

We can execute the commands by typing @F!LEA@). 

When you use SEDIT to edit a text file, it automatically 
extends the byte length of the file to an even multiple 
of 512[ bytes. If you open a location beyond the 
existing end-of-file (e.g., location 1001 in FILEA 
above), SEDIT automatically extends the file to the 
next multiple of 1000 (512, ) bytes. 



End of Chapter 
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Chapter 3 
Searches, Displays and Registers 



The material in this chapter and the next relates 
primarily to editing sore files, not text files. 

Often you will want to search a file for a specific word, 
or display entire blocks of words on the console or line 
printer. This chapter explains the search and display 
commands and the special SEDIT registers which can 
help you use these commands effectively. 



Search Command ($S) 

With the Search command (SS), you can search 
forward in the file for the contents of any address (e.g., 
JSR @ 17). To search to a location, type addressSS , 
and SEDIT will search forward from address zero and 
stop when it reaches address. 

To search for the contents of an address, you must 
open the Word register with the SW command, type the 
word you want SEDIT to find, and close the Word 
register. Then you type SM to open the Mask register, 
enter a mask word, and close it. If the Mask register 
contains zero (default), the search will match all words 
in the file. To match a specific word, instead of a 
general group, enter -1 (17777?) in the Mask register. 



You can also set an increment for the search with the 
Search Increment Register; you can direct output to the 
line printer by placing 1 in the Output register. 

Having set these registers (which are described later in 
this chapter), you enter your Search command, and 
SEDIT seeks matching contents in the file. 

The formats of the Search command are: 

addrSS Search from location to addr. 

SS Search entire file for value in Word 

register. 
<addrSS Search from location zero to addrfor 

value in Word register, 
addr < SS Search from addr to last location for 

Word value. 
addr<addr$S Search from addr to addr for Word 

value. 

If you omit addr, SEDIT assumes zero as the lowest 
address and 77777 as the highest address. When SEDIT 
finds a word matching the contents of the Word 
register, it displays addr and its contents in the current 
display mode. If you have enabled symbols, it displays 
locations symbolically, as in Figure 3-1. 
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SEDITROOT) 
SEDITx.xx 

ROOT% 

.ERSS 

+ 000000 

OVLY1 000000 



RTURN + 2 000401 

ER 006017 

. .- 000503 .: ER + 1 } 

.SW000000JSRS17 ) 

.SW 00601 7 ;JSR @ +17) 
.SM 00000Q-\ ) 

.ss 

START +2 00060 1 7 
START +6 00601 7 



DEBUG + 01277 006017 

• S; 

.SS 

START+2JSROV1 + 16 
START+6JSROV1 + 16 

DEBUG + 1277JSR & O VI + 16 

.SK 

.SS 

+ 454 J SR mil 

+ 460 JSR W 17 

2515JSR @ 17 
.1SK 



Enable local symbols. 

Display Hie to location ER. 

SEDIT always searches for locations from location 0; thus it may take 

some time to reach location ER 



Found! 

Current position is 503, symbolically ER+ 1. 

Now to find locations containing JSR 2 17. First, place JSR 3 17 in Word 

Register. 

Verify new value in Word register. 

To match a word specifically, place -1 in Mask register. 

Search the save Tile for JSR @ 17. SEDIT displays the locations 

symbolically that contain JSR @ 17. 



Change display to instruction mode. 

Search again. 

SEDIT displays contents in instruction format. 



Kill all symbols (see Chapter 4). 

Search again. 

Display locations in octal, contents in instruction format. 



Re-enable global symbols. 



Figure 3-1. SEDIT $S Command Example 



Another example is: 

.SW 000000 .WRLO) 

.SM 000000-1 ) 

.S\ 

.400 <SS 



5 53 6. WRLO 
7666 . WRL 



Insert .WRL in Word register. 
Insert -1 in Mask register. 
Change to .SYSTM call mode. 
Search from location 400 
upward. 

Display in system call format. 
There are two write lines to 
channel in this program. 

See the register sections below for more examples of 
the Search command. 

Display Command ($D) 

The Display command CSD) resembles the Search 
command, except that it cannot search for the contents 
of a location, and it displays the contents of eight 
locations on one line You can display on the line 
printer by setting the Output registe:" to 1. and you can 



set the Search Increment register to display locations at 
desired increments. The SD command always displays 
contents in octal; you cannot change the output of SD 
to other formats. 

The formats for the Display command are: 

addrSD Display contents from location to 

addr. 
SD Display contents of all locations. 

addr<SD Display from location addr to last 

location. 
addr<addr$D Display from addr to addr. 

Figure 3-2 shows display examples. The first example 
displays locations one through 20, and locations 400 
through 450 in a save file. Like most save files, this one 
uses only location 17 (in first range); its User Status 
Table, TCB(s), and overlay directory (if any) start at 
400 (second range). The second example displays 
locations in a texi file. 
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SEDITROOT ) 

SEDITREVx.xx 

20SD 

+ 000000 000000 000000 000000 000000 000000 000000 000000 

Ol'LYl + 7 000000 000000 000000 000000 000000 000000 000000 001155 

OVLYl + 17 000000 

.400<500SD 

"USTAD 000000 000060 006634 006114 006635 001120 001216 006635 
USTAD + 10 000000 177777 177777 000410 000424 000424 177777 00452 
USTAD + 20 000445 000000 177777 000000 001124 000000 000000 000000 
USTAD + 30 000000 000000 000000 177777 000000 000000 000000 000000 
USTAD + 40 000000 000000 000000 000000 000000 000001 177400 001001 
USTAD + 50 000000 000517 020440 126400 006017 012000 000424 020426 
START +6 006017 010000 000420 020423 126400 006017 020000 000413 
LOVO + 5 002420 020416 126400 006017 020000 000405 002413 006017 
RTURS+1 004400" 



sz 

DOSE. 
R 

SEDiT/N/ZTESTFILE) 
SEDlTREV.x.xx 

.0 10SD 

+0 046505 051523 040507 042440 052110 044523 020111 051440 

+ 10 052105 



Figure 3-2. Displaying Locations 



SEDIT Registers 



SEDIT registers are locations into which you can insert 
values. These values control I/O and numeric output, 
searches, and displays. There are five registers: Output, 
Number, Search Increment, Mask, and Word. You can 
use all the registers for searches; you can use the first 
three for displays. 

The value in each register is initially zero (except for 
the Search Increment Register). Any value you insert 
reverts to the default when you leave SEDIT and 
return to the CLI. 

Output Register ($H) 

By default, SEDIT sends Search and Display output to 
the console. You can direct this output to the line 
printer by entering the value 1 in the output register. 
Use the SH command to open and examine this 
register; you can then change it if you want. For 
example: 

SH 000000 1 ) 

directs output of Search and Display commands to the 
line printer. When output of Search commands goes to 
the primer, SEDIT inserts the value (in current output 
mode) of the sought word before the contents of each 



address. Display command output is the same on both 
console and printer. 

Number Register ($N) 

By default, SEDIT displays numbers in octal, unsigned, 
with leading zeroes. You can tell it to output numbers 
with a leading sign, suppress leading zeroes, or select 
radix 8, 10, or 16 by placing the proper value in the 
number register. Use the SN command to open and 
examine this register; you can then insert a new value if 
you want. 

New value: Setsbit(s): Effect: 



100000 


BO 


Sign numbers. 


040000 


Bl 


Suppress leading zeroes. 


000010 


B12 


Display in octal. 


(or 000000) 


none 


Same. 


000012 


B12,B14 


Display in decimal (10 
same effect). 


000020 


Bll 


Display in hexadecimal 
has same effect). 



has 



(16. 



You can enter combinations of these values in the 
number register. If you enter any value but those 
above, SEDIT uses the default radix (octal). 
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.START/ 020440 ) 
.SN 000000 10. ) 
.START/ 084S0. ) 
,4440=02336, ) 
.SN 000010 140000) 



.START/ +20440} 
.SN-/000016. ) 

.START/ 2 /JO// 
1 5 = 000D// 



Default octal display. 

Specify decimal numbers. 
Display in decimal. 
Convert an octal number. 
Insert sign, suppress leading 
zeroes, display in octal. 
SEDIT follows orders. 
Convert to hexadecimal. 
Terminal H means hex output. 



Search Increment Register ($J) 

By default, SEDIT increments locations by one in 
Search and Display commands. You can specify a 
different increment by opening the Search Increment 
Register and inserting the increment you want. The SJ 
command opens this register. 

The default value in the Search Increment Register is 
000001; a negative or value is illegal, and will produce 
the default value. 



.SN 000000 40000 } 
.SM 0-1 } 
.SW0STA3, 50) 

.ss 

DEBUG + 527 54050 
DEBUG ' + 572 54050 
DEBUG + 1075 54050 
.SJ 14) 

.SS 

DEBUG + 572 54050 

.SW 5 40 50 Q) 
.SS 
+ 00 

OVLY1+3 
OVLY1 + 70 
OVLY1 + 130 

.SJ <H0 ) 

.<400SD 
0. ...... . 

OVLY1 + 77. ..... 

OVLY1 + 177. .... 

OVLY 1+277. .... 

USTAD, ...... 

.SJ 701 ) 



Suppress leading zeroes. 

Set Mask register to -I. 

Insert STA 3, 50 in Word 

register. 

Search all locations for STA 3, 

50. 



Specify increment of 4 in 

Search Increment register. 

Search again. 

There's only one STA 3, 50 at 

an increment of 4 from zero. 

Place in Word register. 

Search again. 

There are plenty of locations 

which contain 0. 



Place increment of 10 in 

register. 

Try a display command. 



Specify a 
increment of 1. 



search/display 
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you've seen earlier in this chapter, you insert the word 
you want matched in the Word register. After you issue 
the Search command, SEDIT searches each location 
and ANDs the value in the Mask register with the 
location's contents. If this value matches the Word 
register, SEDIT announces a match. The default value 
for both registers is 000000. 

Because SEDIT ANDs the" mask with the contents, and 
the default mask is 000000, there will be no match 
unless you set the Mask register. To match a specific 
word, insert -1 in this register. To match only a portion 
of a word, set the bits which contain that portion to 1 in 
the mask register, and set the other bits to 0. 

The command 
SM 

opens the Mask register and displays the contents. 

Place the value you want SEDIT to match in the Word 
register. You can enter this in any format (e.g., MOVS 
0, 101300, or .WRL 0). The command 

SW 

opens the Word register and displays its contents. The 
following example shows application of the Word and 
Mask registers in Search commands. 

SEDIT ROOT) 
SEDIT REV x.xx 
.SM 000000-1 ) 



.SW 000000 .RDLO) 

.SS 

5742 015400 
.1 5400 \. RDLO 



Set mask register to 177777 (16 

ones). 

Insert read line call in Mask 

register. 

Search all locations. 

One match. 

Check 15400; it's. RDLO. 



The Mask register can help you search for all 
occurrences of one type of instruction. For example, 
assume that you want to find all "MOVZL" instructions 
in a program. The octal instruction is 101120, but this 
applies only to MOVZL 0,0; with any other 
accumulators there will be no match. Bits 1 through 4 
specify accumulators in MOV instructions, so "you 
mask them out by inserting a word which contains in 
bits 1,2,3, and 4, and 1 in the other bits. This word is 
103777: 



SEDIT SYS ) 
SEDIT REV x.xx 
.SW 000000 MOVZL ) 

.SM 000000 103777) 

.<4000SS 



Mask and Word Registers ($M and $VV) 

SEDIT uses both the Mask and Word registers for 
searches. If you want to search for a specific 
instruction, you must set both of these registers. As 

End of Chapter 



2535 1 55 J 20 

2536175120 

.1551 20; MOVZL 2 3) 

.175120; MOVZL 3 3 



Insert MOVZL in Word 

register. 

Insert MOVZL mask 

Mask register. 

Search from location 

4000 for MOVZLs. 

One match. 

Two matches. 

Check the match words. 

The MOVZL mask works 



in 



to 
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Chapter 4 
Enabling and Disabling Symbols 



As described in Chapter 2, global symbols are those 
declared in .ENT statements in a program. To 
recognize global symbols, SED1T requires only that a 
save file include a program symbol table. The RLDR/D 
command will include both a program symbol table and 
a debugger; a .EXTN .SYM. statement in any program 
module will include only the symbol table. SEDIT 
always recognizes global symbols (unless you disable 
them). 

SEDIT will also recognize, local symbols (those not 
declared with .ENT), //you assembled the program 
source file(s) using the global /U switch, and //you 
used local /U in the RLDR command line. To enable 
local overlay symbols, append local /U to the overlay 
name in the brackets; for example: 

RLDR/D MYPROG/U MYPROG1/U [OVLYO/U, f) 
OVLY1/U] ) 

When you proceed through a file, examining locations, 
SEDIT displays each location as it relates to the nearest 
previous symbol defined. However, if the nearest 
previous symbol is more than 2000 g locations away, 
SEDIT displays the octal, not the symbolic, value of the 
location. 



Enabling Symbols 



If the program has a symbol table, SEDIT will 
understand all global symbols when you invoke it. To 
enable local symbols in any program module or 
overlay, type: 

name% 

where name is the module name, as assigned by the 
.TITL pseudo-op. The name is not necessarily the 

filename. If .TITL was omitted from the module, the 
default name is .MAIN. The name% command enables 
all local symbols in this module. It also disables local 
symbols in only one module at a time. 



To edit overlays symbolically, see "Editing Overlays" 
in Chapter 2. 

To enable global symbols after you have killed all 
symbols (SK, below), type: 



nSK 



where n is a single octal digit (1 is convenient). 

In any module, to enable all symbols that you have not 
individually disabled, type: 

name°'o 

as above. 



Disabling Symbols 



If there are a lot of local symbols, they can cloud your 
overview while you are editing; also, an individual 
symbol can interfere with editing if its value happens to 
fall at the wrong point. Occasionally, even global 
symbols hamper editing. You can disable all symbols, 
or individual symbols, with the command: 

SK 

For example: 

SEDIT MYPROG } Invoke SEDIT. 

SEDITREVx.xx 

.START/ 0240440 START was .ENTered. 

.SK Disable all symbols. 

.START/ U START is now Undefined. 



To disable any single symbol, type: 
nameSK 

where name in the symbol name. Note that SEDIT will 
still recognize the symbol when you type it in, but 
won't display it when you proceed forward or backward 
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through locations in the file. Instead. SEDIT displays 

the disabled symbol's locations as it relates to the 
preceding active symbol (if the previous symbol is less 
than 2000g locations away - see above). 

When you disable output of a single symbol, you 
cannot > re-enable it during this SEDIT session. *To 
re-enable the disabled svmbol, leave SEDIT and return 
to SEDIT. 

For example, assume that program ROOT starts at 
symbolic location START, and the next symbol is 
LOV0. (Mere, it doesn't matter whether START and 
LOV0 are global or local symbols.) 



SEDIT ROOT } 
SEDlTREYx.xx 
.ROOT% 
.START/ 020440 \ 

START +11 26400 
START -+2 0060 17 



START + 10 0004201 
LOV0 020423) 
.LOVOSK 

.ST ART +10/ 0004201 

START + 11 020423 



.LOVO/ 020423 



.$Z 
DONE. 

R 

SEDIT ROOT ) 
SEDIT REV x.xx 

.ROOT% 

.START+ 10/ 000420 

LOVO 020423 



Enable all symbols. 
Open and display location 
START, then next location. 
Continue... 



Proceed to location LOVO. 

Disable LOVO for this session. 

Check START+10 

(unchanged). 

What SEDIT displayed as 

LOVO, it now displays as 

START+11. 

SEDIT still recognizes LOVO 

on input, but does not display 

it. 

Leave SEDIT. 



Re-enter SEDIT. 

Enable local symbols again. 
Check LOVO display... 
LOVO display is enabled. 
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Managing Symbols 

To enable global symbols while editing, you need do 
nothing if you have used the global /D switch in the 
RLDR command, or an .EXTN .SYM. statement in a 
source module. 

To enable local symbols, type name% (you must have 
used the assembler global /U and RLDR local /U 
switches). 

To disable all symbols, type SK. 

To disable the display of any svmbol, tvpe 
symbofnameSK. 

To re-enable global symbols type 1SK (or any digit 
instead of 1). The sequence SK, 1$K disables all 
symbols and re-enables globals. 

To re-enable all but explicitly disabled svmbols. type 
name%. 

By default, when you include the global /D switch in 
the RLDR command, RLDR places the debugger 
directly above your program, and places the svmbol 
table (which either SEDIT or the debugger needs), 
directly above the debugger. If you use a .EXTN .SYm! 
in a program module, and omit RLDR global /D, the 
symbol table will be directly above the program.Vne 
load map (if you specified one with the RLDR local /L 
switch) will tell you the location of each global symbol, 
the start address of the debugger (if present) and the 
start and end address of the symbol table. If the 
program lacks a symbol table, you can use the 
addresses in the load map to patch, but this is much 
more awkward than using symbols. 

Symbol Example 

Figure 4-1 shows various attempts to disable a 
distracting symbol. 
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SED1TMYPROG ) 




SEDITREV.X.XX 




.SN 0000(10 40000 ) 


Suppress leading zeroes (to help fit this example into one column). 


START/ 2Q440;LDA ER + 10 


Display location START. 


■ S; 


Display in instruction mode. 


.MYPROG% 


Enable all symbols. 


.START/ LDAOOFILE I 


Local symbol OFILE replaces global ER-HO. 


START+ISUB1 I i 


Examine succeeding locations. 


.LOCP-r4//.VC0 1 


Examine LOOP + 4, then next location. 


LOOP ^5 COM SIR I 


And next... 


RTCNS JMP RTCNS + 10 1 


Encounter symbol RTCNS, but we find RTCNS a little confusing. 


R TCSS +1ST.4 0R TC\S +15) 




."5005) 


Check current location in octal, and symbolically. 


. .: RTCXS+1 ) 




.SK 


Disable all symbols and enable global symbols; this disables RTCNS if it is a 


.1SK 


local symbol. 


. .:RTC\S+1 ) 


Check current location symbolically; find that RTCNS is still enabled -- thus 




it is global. 


.RTCNSSK 


Disable RTCNS specifically. 


. .-.START+27) 


RTCNS is not displayed. 


.MYPROG% 


Re-enable local symbols. 


.LOOP + 6/JMPLOOP+16 \ 


Continue editing. 


SZ 

DONE. 
R 






Figure 4-1. Disabling and Enabling Symbols ___ 



End of Chapter 
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Chapter 5 
SEDIT Command Summary 



This chapter summarizes SEDIT commands in Table 5-1. First, it presents character commands (e.g.,.&), then 
Setter commands in alphabetical order. 

Table 5-1. SEDIT Command Summary 



Command 


Meaning 


Example 


/ 


Use contents as addr, open and display 


400/ 000000 


addr/ 


Open addr, display contents. 


START/ LDA OOVI 


addr! 


Open addr, display nothing. 


START! 


NL/LF 


Open next addr, display contents. 


1 START + SUB 1 1 


! (SHIFT-6) 

or 

(SHIFT-N) 


Open previous addr, display contents. 


! 

START LDA OOVI 


) (RETURN) 


Close current location (if open), insert new value (if any), give prompt. 


AND 1 2ANDS 1 2 ) 


.- 


Display current location in current radix. 


. = 000402 




Display current location symbolically. 


.-.START 


- 


Display last entry in current radix. 


SUB 1 1 - 126400 


s- 


Change display mode to numeric, current radix (default is 8). 


$ = 


; 


Display last entry as an instruction. 


1 26400 ; SUB 11 


S; 


Change display mode to instruction. 


$; 


- 


Display last entry in ASCII, 


046505* ME 


$' 


Change display mode to ASCII. 


$' 


\ (backslash) 


Display last entry in .SYSTM format. 


01 7000\ . WRL 


$\ 


Change display mode to .SYSTM format. 


$\ 




Display last entry in symbolic format. 


020423: LOVO 


S; 


Change display mode to symbolic format. 


$: 
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Table 5-1. SEDIT Command Summary (continued) 



Command 


Meaning 


Example 


• 


Display last entry as symbol, 0B0. 


177777' 77777 


n. - 


Convert decimal n to current radix. 


9999.- 023417 


nxH 


Convert hex nx to current radix Cn -0-9). 


0EF2H- 007362 


word 1 [word2l 


Convert 2 radix 50 words to symbol. 


131401 [I13034[i?00f 


"XX- 


Display ASCII xx in current radix. 


"HI- 044111 


"xx 


Insert ASCII xx in open addr. 


000000 "HI) 


bytelbyte- 


Display byte, byte in current radix. 


1011 - 004001 


bytelbyte 


Insert byte, byte word in open addr. 


000000 1011 ) 


+ 


Add one number to another or to an address. 


4567 + 123 - 004712 


- 


Subtract one number from another or an address. 


ER-10 - 00452 


name% 


Enable output of all local and global symbols in module name. 


ROOT% 


SD 


Display all locations in file. 


SD 


addrSD 


Display locations from through addr. 


<40SD 


addr SD 


Display locations from addr to end. 


77000<$D 


addraddrSD 


Display locations addr through addr. 


400<500SD 


SH 


Open output register, display contents. sends SD and SS output to console, 
1 to line printer (SLPT). 


SH 000000 1 ) 


SJ 


Open Search Increment register (used in SD and SS), display contents. 


SJ 000001 4 ) 


SK 


Disable output of all symbols. 


SK 


nSK 


Enable all global CENT) symbols. 


1SK 


nameSK 


Disable output of symbol name. 


TEMP2SK 


SM 


Open Mask register (used with SW, in S commands), display contents. 
Insert -1 to match a specific word. 


SM 000000 -1 ) 


SN 


Open Number register, display contents. Insert 100000 to sign output, 40000 
to drop leading zeroes, 12 or 10. for decimal output, 0,8. or 10 for octal 
output and 20 or 16. for hex output. 


SN 000000 140010 } 


ovnameSO 


Load overlay named by .ENTO into node. 


OVLYOSO 


SO 


Load overlay into save file node 0. 


SO 


nodelovSO 


Load overlay ov into node node. Node number goes in left byte, overlay 
number in right byte. 


OHSOorlSO 


$S 


Search a!! locations for value in $W (also use value in SM, SJ, SH for all 

Searches), 


$S 
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Table 5-1. SEDIT Command Summary 'continued) 



Command 


Meaning 


Example 


addrSS 


Search locations from to addr. 


<40SS 


addr<SS 


Search locations from addr to end. 


77000 <SS 


addr<addrSS 


Search locations addr through addr. 


400<500SS 


SW 


Open Word register, display contents. S commands search for the value in 
the Word register. 


SW 000000 STA 3,50) 


sz 


Stop SEDIT and return to CLI. 


SZ 


CTRL, A keys 


Stop current SEDIT command, return prompt. 


CTRL-A 


CTRL. Q keys 


Resume console display, suspended by CTRL-S. 


CTRL-Q 


CTRL, S keys 


Suspend console display, wait for CTRL-Q. 


CTRL-S 



End of Chapter 
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Appendix A 
SEDIT Error Messages 



?or_? 

Your SEDIT command syntax was wrong, or you 
pressed RUBOUT. SEDIT outputs a line feed and 
awaits another command. 

ERROR IN ACCESSING PRINTER 

When you have directed output to the line printer (by 
setting SH to nonzero), SEDIT could not open the 
printer or could not write to it. Perhaps another 
program is using it. 

FILE IS SEQUENTIAL: filename 
SEDIT cannot edit a sequential file. 

FILE NOT FOUND: filename 

SEDIT searched for the file specified, then tried 
searching for the file with the .SV extension, but could 
not find the file. 

HAD PROBLEM OPENING FILE: filename 

SEDIT could not file, or could not open, the file 
specified. 

ILLEGAL OVERLAY ADDRESS 

This is an internal SEDIT error. The node address is 
somehow incorrect. 

ILLEGAL OVERLAY NODE NUMBER 

Either you have specified a node or overlay number 
higher than the file contains, or there is no overlay 
directory. 

INSUFFICIENT MEMORY FOR OVLY TABLE 

On an SO command, SEDIT tried to read the overlay 
directory into memory, but there was not enough 
memory available. 

End of Appendix 



NO INPUT FILE NAME GIVEN IN COMMAND LINE 
You must specify a filename for SEDIT to edit. 

NO OVERLAY LOADED . 

No overlay has been loaded (SO) into the node you 
specified. This message appears only after some overlay 
has been loaded. For example, your program has two 
overlay nodes, you loaded an overlay into one node, 
then tried to access the other node. 

NOT ENOUGH MEMORY FOR SYMBOL TABLE 

The program's symbol table won't fit into memory. 
Alternatively, the file is not a save file and you forgot 
the global /N switch, or inappropriately used the /Z 
switch. 

PROBLEMS OPENING OVERLAY FILE 

SEDIT could not read the overlay directory, or could 
not open the overlay file. SEDIT expects the overlay 
file to have the same name as the save file, with the 
.OL extension. 

SOME PROBLEMS READING SOURCE FILE: filename 

An error occurred as SEDIT tried to open the file or 
read/write to it. 



U 

You have entered an undefined command or symbol 
SEDIT outputs a carriage return and awaits another 
command. To enable local user symbols, use the global 
/U switch in the assembler command line and use the 
local /U switch in the RLDR command line; then type 
modu!ename% from SEDIT. 
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Index 



Within this index, the letter *T* following a page 
number means "and the following page"; "ff" means 
"and the following pages". 

Chapter 5 is a summary of all SEDIT commands, but 
we have not entered Chapter 5's entries in this index. 

! 2-3f 

" (quotation mark) 2-5 

5 see ESC key 

% (percent) 4- If 

6 (ampersand) 2-3 
' (apostrophe) 2-3f 
* (asterisk) 2-3 

+ (plus) 2-5 

— (minus) 2-5 

. (period) 2-3f 
/ (slash) 2-3f 
: (colon) 2-3f 
; (semicolon) 2-3f 

— (equal sign) 2-3 
[ (left bracket) 2-4 
\ (backslash) 2-3f 

] (right bracket) 2-5,2-7 
| (uparrow) 

command 2-3 

definition of 1-lf 

— (backarrow) 2-3 

) (carriage return) 1-1 

ASCII characters 2-5 

byte entry 2-5 

calculations 2-5 
commands 

definition of 2-3 

display 3-2ff 

display mode 2-3f 

format of 2-2 

global/local 2-2, 2-4, 4- Iff 



location 2-3 

overview 1-1 

register 3-3f 

search 3-lf 
consoles 1-1 
CTRL-A 1-2 
CTRL-Q 1-2 
CTRL-S 1-2 

display 

command 3-2ff 
mode commands 2-4f 

.ENTO 2-5 

error 

messages A-l 

responses 1-2 

typing 1-2 
ESC key 1-2,2-2,2-4 

H (output register) 3-3 
hexadecimal (H) 2-3f 

J (search increment register) 3-4 

load map 2-2 

M (mask register) 3-4 

N (number register) 3-3f 

NEW LINE key 1-lf, 2-3 
Number register 3-3f 

O (overlay symbols) 2-5 
organization of manual iii 
overlays, editing 2-5f 
output register 3-3 

registers 3-3f 

RETURNkevC)) 1-lf, 2-3 
RUBOUTkey 1-2 
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S (search) 3- if, 3-4 

search increment register 3-4 

searches 3-1 f, 3-4 

SEDIT 

commands see commands 

error 

messages A-l 
responses 1-2 

invoking 2-1 

overview 1-1 

switches 2-1 

symbols, see symbols 
special characters 1-lf 
switches, see SEDIT switches 



symbols 

disabling, enabling 4- Iff 

documentation iiif 

global, local, definition of 2-2 

overlay 2-5 

using 4- Iff 
symbol table 

examining 2-4 

including in file 4-2 
symbolic editor, see SEDIT 

text files 2-7 

W (word register) 3-4 
Word register 3-4 
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